{ToolManager

{En udvidelse af Amiga Workbench

{

{Version 3.0

{23 Feb 1997

Det tillades herved at lave og distribuere eksakte kopier af denne manual under foruds�tning af at copyright-angivelsen og denne tilladelse bevares p� alle kopier.

COPYRIGHT

Copyright © 1990–1997 Stefan Becker

Ingen programmer, dokumenter, datafiler eller kildetekster fra denne software-pakke m�, hverken helt eller delvist, inkluderes eller anvendes i andre software-pakker medmindre det er godkendt ved en skriftlig tilladelse fra autor.

INGEN GARANTI

Der gives ingen garanti for denne software-pakke. Selvom autor har fors�gt at forebygge fejl kan han ikke garantere at den software-pakke, som beskrives i dette dokument, er 100% p�lidelig. Du anvender derfor dette materiale p� eget ansvar. Autor kan ikke g�res ansvarlig for nogen skade som for�rsages af anvendelsen af denne software-pakke.

DISTRIBUTION

Denne software-pakke er frit distribuerbar. Den m� overf�res til ethvert medie som anvendes til distribution af gratis software s�som Public Domain-disketteserier, cd-rom’er, FTP-servere eller BBS’er.

For at sikre integriteten af denne software-pakke b�r distribut�rer benytte de originale arkivfiler:

Autor kan ikke g�res ansvarlig hvis denne software-pakke er blevet uanvendelig p� grund af �ndringer i arkivindholdet eller i selve arkivfilerne.

Der er ingen begr�nsning p� den afgift som distribut�rer m� opkr�ve, dvs. for medieomkostninger til disketter, magnetb�nd eller cd’er, eller mangfoldigg�relsesprocessen. S�danne begr�nsninger har vist sig at skade ideen om frit distribuerbar software, f.eks. ved at software-pakken blev fjernet i stedet for at reducere prisen p� en diskette til under gr�nsen.

Selvom autor ikke s�tter nogen begr�nsning p� disse afgifter �nsker han at udtrykke sin personlige holdning til emnet:

• Denne software-pakke b�r v�re gratis tilg�ngelig for alle n�rsomhelst dette er muligt.
• Hvis du har anskaffet denne software-pakke under normale omst�ndigheder fra en Public Domain-handler p� en diskette og har betalt mere end 5 DM eller 5 amerikanske dollars, s� har du ubetinget betalt for meget. Du b�r ikke st�tte dette utilb�rlige profitmageri fremover, og du b�r skifte til en billigere kilde snarest muligt.

BEGR�NSNINGER FOR ANVENDELSEN

Ingen programmer, dokumenter, datafiler eller kildetekster fra denne software-pakke m�, hverken helt eller delvist, anvendes p� nogen maskine som benyttes

• til forskning, udvikling, konstruktion, afpr�vning eller produktion af v�ben eller andre milit�re form�l. Dette omfatter ogs� enhver maskine som benyttes til uddannelse med nogen af de ovenn�vnte form�l.
• af personer som accepterer, st�tter eller ud�ver vold mod andre, f.eks. borgere fra andre lande.

(Denne side er tilsigtet blank)

\input tex:texinfo.tex

1 Hvis du kan lide ToolManager…

ToolManager er GiftWare, ikke ShareWare!

S� hvis du kan lide programmet og bruger det meget ofte, s� skulle du overveje at sende en lille donation eller gave som anerkendelse for det arbejde jeg har lagt i dette program. Jeg foresl�r en donation p� 10–20 amerikanske dollars eller 10–20 DM. Send ikke checks eller IMO’er fra lande udenfor Europa, da de som regel koster mere at indl�se end de lyder p�.

Hvis du ikke har r�d til en donation beh�ver du ikke at have d�rlig samvittighed over det. Men du skal sende mig i det mindste et postkort eller brev og fort�lle at du bruger ToolManager (jeg kan godt lide at f� fan-post :-). See section Autor.

2 Om ToolManagers fremtid

Siden sidste store udgivelse af ToolManager 2.1 i maj 1993 har det v�ret en problemfyldt tid for Amigaen og dens brugere. I skrivende stund ser fremtiden stadig ikke alt for lovende ud. Alligevel har jeg besluttet at udvikle denne nye version af ToolManager 3.0 p� grund af den enorme m�ngde tilbagemeldinger jeg har f�et fra hundreder af tilfredse brugere.

Min trofaste A3000 er ved at blive gammel, og givet den aktuelle situation er det uklart hvilken retning Amigaen bev�ger sig i. Jeg har ikke r�d til at k�be alle mulige opgraderinger eller nogen af de nye maskiner (n�r/hvis de kommer), da dette projekt kun er min hobby. S� det afh�nger af jeres tilbagemeldinger og donationer om jeg vil v�re i stand til at arbejde p� fremtidige versioner af ToolManager.

Dette er ogs� en opfordring til de firmaer som arbejder p� de fremtidige Amigaer (Amiga Technologies, Phase5, ProDAD, VisCorp eller hvem der for tiden er involveret). Jeg er kun en FD-autor og har ikke r�d til at k�be alle mulige systemer eller betale for udviklermaterialer for dem. S� jeg har brug for jeres st�tte hvis I vil se ToolManager k�re p� jeres system. Husk at ToolManager er et af de (om ikke det) mest brugte v�rkt�jer p� Amigaen, og derfor vil det v�re en fordel for jeres system.

ToolManagers fremtid afh�nger af JERES st�tte!

3 Hvorhen du kan sende fejlrapporter, kommentarer og gaver

Autor kan kontaktes p� f�lgende adresser:

Postadresse:

        Stefan Becker
        Bonner Ring 68
D-50374 Erfstadt
        TYSKLAND

Elektronisk post:

stefanb@yello.ping.de

Der findes ogs� en ToolManager-hjemmeside p� World Wide Web:

http://www.ping.de/sites/yello/toolmanager.html

4 Hvad kr�ves for at afvikle ToolManager?

ToolManager kr�ver mindst:

AmigaOS 3.0 (V39)

eller bedre for hukommelsespuljer og picture.datatype.

WBStart 2.2

Dette s�tter ToolManager i stand til at starte Workbench-programmer.

DOSPath 1.0

Dette s�tter ToolManager i stand til at h�ndtere AmigaDOS-s�gestier.

Desuden underst�ttes:

ScreenNotify 1.0

Denne pakke s�tter ToolManager i stand til at �bne og lukke sine dok-vinduer n�r offentlige sk�rme �bner eller lukker.

picture.datatype V43

Udvidelserne i denne forbedrede picture.datatype underst�ttes automatisk hvis den er installeret p� dit system. See section Anerkendelser.

Indstillingsprogrammet kr�ver:

AmigaOS 3.0 (V39)

eller bedre for hukommelsespuljer.

MUI 3.7

Det objektorienterede GUI-system. See section Oplysninger om MUI.

Pophotkey, Popport, Popposition

MUI-specialklasser for duk-op-objekter. See section Anerkendelser.

5 Hvordan ToolManager installeres

Benyt det medleverede Installer-program til at installere ToolManager. Det kr�ver AmigaOS’ Installer V43.3. Denne version kan findes p� Aminet.

S�rg for at afslutte den gamle ToolManager f�rst inden du installerer den nye version!

6 Begreber som ToolManager bygger p�

ToolManager er et program som g�r det muligt at starte dine programmer p� en meget enkel m�de. Man kan starte programmer ved brug af tastaturgenveje (see section Genvejstaster), ved at v�lge et punkt i Workbench’s V�rkt�js-menu eller ved at klikke p� et ikon enten p� Workbench eller i specielle dok-vinduer. Man kan endda tr�kke ikoner fra Workbench-skuffer hen p� disse ikoner for at overgive filer til programmerne. Desuden kan man fasts�tte en lyd for hver af disse handlinger.

Alt dette styres af ToolManager-objekter. Hvert objekt har en bestemt opgave og indeholder oplysninger om hvordan denne opgave udf�res. F.eks. repr�senteres programmer som kommandoobjekter og indeholder oplysninger om programnavnet og stakst�rrelsen.

Der er to slags objekter. Objekttyperne Kommando, Billede og Lyd kaldes simple objekter fordi de kun indeholder oplysninger om �n kommando, �t billede og �n lyd.

Objekttyperne Menu, Ikon og Dok kaldes sammensatte objekter fordi de binder flere simple objekter sammen for at udf�re deres opgaver. F.eks. repr�senteres et ikon p� Workbench af et ikonobjekt som er k�det sammen med et billedobjekt for ikonets billede og et kommandoobjekt som starter en kommando n�r ikonet �bnes.

6.1 Kommandoer

Et kommandoobjekt indeholder oplysninger om en kommando som startes n�r objektet aktiveres. Objektet kan aktiveres direkte af brugeren ved hj�lp af en genvejstast eller via et sammensat objekt. Ved aktivering kan et antal filer angives, som s� overleveres til kommandoprogrammet som startargumenter. Kommandoobjekter indstilles med kommandoobjekt-indstillingsvinduet.

ToolManager kan afvikle forskellige slags kommandoer:

Shell

Kommandoen afvikles som en shell-kommando ligesom hvis brugeren havde indtastet kommandolinien i en shell. Shell-kommandofiler skal startes p� denne m�de. Man kan bruge de s�dvanlige ‘[]’-markeringer til at angive hvor fil-argumenterne skal inds�ttes i kommandolinien.

Workbench

En start fra Workbench simuleres. Alle filer medgives som Workbench-argumenter. Rene shell-programmer og kommandofiler virker ikke n�r de startes som Workbench-programmer.

ARexx

Et ARexx-program eller en ARexx-kommando afvikles.

Dok

Kommandoen angiver et ToolManager-dok-objekt som skal aktiveres. Man kan bruge denne kommandotype til at lave dokker som er indlejret i andre dokker.

Genvejstast

En genvejstast s�ttes op. Dette kan benyttes til at styre et andet program fra ToolManager.

6.2 Billeder

Et billedobjekt indeholder oplysninger om et billede som benyttes af et sammensat objekt. ToolManager kan indl�se Workbench-ikoner som benyttes af ikonobjekter. N�r et dok-objekt benytter et billede, indl�ses dets data ved hj�lp af datatype-systemet. Derved kan ToolManager benytte ethvert billede som du har installeret en gyldig datatype for p� dit system. Billedobjekter indstilles med billedobjekt-indstillingsvinduet.

6.3 Lyde

Et lydobjekt indeholder oplysninger om en lydkommando. Denne lydkommando sendes som en ARexx-kommando til et eksternt lydafspilningsprogram. Lydobjekter indstilles med lydobjekt-indstillingsvinduet.

6.4 Punkter i Workbenchs V�rkt�js-menu

Et menuobjekt er et sammensat objekt som binder et kommandoobjekt og et lydobjekt sammen som et punkt i Workbenchs V�rkt�js-menu. N�r dette menupunkt v�lges, aktiveres kommandoobjektet og lydobjektet. Alle markerede ikoner p� Workbench benyttes som startargumenter for kommandoen. Menuobjekter indstilles med menuobjekt-indstillingsvinduet.

6.5 Ikoner i Workbench-vinduet

Et ikonobjekt er et sammensat objekt som binder et kommandoobjekt, et billedobjekt og et lydobjekt sammen som et ikon i Workbench-vinduet. Billedobjektet benyttes til at danne ikonets billede. Ikonobjekter indstilles med ikonobjekt-indstillingsvinduet.

Ikoner kan aktiveres p� to m�der. Brugeren kan dobbeltklikke p� ikonet, eller han kan markere ikoner p� Workbench og tr�kke dem hen p� ikonet. N�r ikonet aktiveres, aktiveres ogs� kommando- og lydobjekterne. Ikoner som er trukket hen p� objektets ikon benyttes som startargumenter for kommandoen.

6.6 Knapvinduer

Et dok-objekt er et sammensat objekt som viser et vindue med knapr�kker for brugeren. Hver knap binder et kommandoobjekt, et billedobjekt og et lydobjekt sammen. Hver knap kan vise enten et billede, en tekst eller begge dele. Kommandoobjektets navn benyttes til teksten. Billedobjektet benyttes til billedet. Dok-objekter indstilles med dok-objekt-indstillingsvinduet.

Hver knap kan aktiveres p� to m�der. Brugeren kan klikke p� knappen, eller han kan markere ikoner p� Workbench og tr�kke dem hen p� knappen. N�r ikonet aktiveres, aktiveres ogs� kommando- og lydobjekterne. Markerede ikoner benyttes som startargumenter for kommandoen.

Et dok-objekt kan “aktiveres” med en genvejstast. N�r dokvinduet er lukket, og brugeren anvender genvejstasten, s� �bnes dok-vinduet og omvendt.

Hvis ‘screennotify.library’ er installeret, kan ToolManager �bne og lukke dok-vinduer automatisk. N�r en sk�rm er ved at blive lukket, lukkes alle dok-vinduer p� denne sk�rm f�rst. N�r den offentlige sk�rm �bnes igen, vil alle dok-vinduer for denne sk�rm blive �bnet igen.

7 Hvordan ToolManager indstilles

ToolManagers indstillingsprogram benyttes til at indstille ToolManager.

Objektindstillingsvinduer:

Diverse vinduer:

Indstillingsprogrammet forst�r de almindelige tooltyper og shell-kommandoargumenter:

FROM (kun shell)

Angiver navnet p� filen hvorfra programmet skal indl�se indstillingerne.

EDIT (standard)

Redigering af indstillingerne.

USE

Midlertidig anvendelse af de angivne indstillinger.

SAVE

Permanent anvendelse af de angivne indstillinger.

CREATEICONS

Der oprettes ikoner for indstillingsfilerne n�r de gemmes. N�r det startes fra Workbench, opretter indstillingsprogrammet som standard ikoner. N�r det startes fra shell, oprettes som standard ingen ikoner.

7.1 Hovedvinduet

Hovedvinduet indeholder objektlisterne. Ved at klikke p� objekttypen kan man v�lge hvilken liste der aktuelt vises. Hver liste kan indeholde flere grupper. Hver gruppe kan have flere objekter.

Et dobbeltklik p� en gruppes navn �bner grupperedigeringsvinduet. Ved at klikke p� symbolet til venstre for gruppen �bner og lukker man gruppen. Hvis en gruppe er �ben, kan man se alle objekterne i denne gruppe. Et dobbeltklik p� et objekts navn �bner objektets indstillingsvindue.

For at flytte en gruppe markerer man f�rst �n, tr�kker den til den nye plads mens man holder venstre musetast nede, og slipper s� musetasten. Man kan ogs� flytte objekter mellem lister p� denne m�de.

I forbindelse med listen er der fire knapper:

Ny gruppe

Opretter en ny tom gruppe. Grupperedigeringsvinduet vil blive �bnet, s� man kan angive navnet p� den nye gruppe.

Nyt objekt

Opretter et nyt objekt i den markerede gruppe. Objektindstillingsvinduet vil blive �bnet, s� man kan indstille det nye objekts egenskaber.

Slette

Sletter den markerede gruppe eller det markerede objekt. Hvis en gruppe er markeret, vil ogs� alle objekter i denne gruppe blive slettet.

Sortere

Hvis et objekt eller en �ben gruppe er markeret, vil indholdet af denne gruppe blive sorteret alfabetisk. Ellers vil grupperne blive sorteret alfabetisk.

Med knapperne i bunden af hovedvinduet kan man angive hvor indstillingsprogrammet skal gemme indstillingerne. Navnet p� indstillingsfilen er ‘ToolManager.prefs’.

Gemme

Gemmer indstillingerne i ‘ENVARC:’ og ‘ENV:’. De nye indstillinger tages automatisk i brug og overlever genstart af datamaten. Efter at indstillingerne er gemt, forlades programmet.

Benytte

Gemmer indstillingerne i ‘ENV:’. De nye indstillinger tages automatisk i brug, men de overlever ikke genstart af datamaten. Efter at indstillingerne er gemt, forlades programmet.

Afpr�ve

Gemmer indstillingerne i ‘ENV:’. De nye indstillinger tages automatisk i brug, men de overlever ikke genstart af datamaten. Indstillingsprogrammet forlades ikke.

Fortryde

Indstillingsprogrammet forlades. Alle �ndringer, som ikke er gemt, vil blive annulleret.

7.2 Hvordan man indstiller kommandoobjekter

Kommandoobjekter indeholder oplysninger om kommandoer. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn.

Kommandotype

Kommandoens type. Man kan v�lge mellem Shell, Workbench, ARexx, Dok, Genvejstast og Netv�rk. Typen Netv�rk er ikke underst�ttet i �jeblikket.

Kommando

Kommandoens navn. Dette er enten kommandoprogrammets filnavn eller navnet p� et dok-objekt eller en genvejstast-definition, afh�ngig af kommandotypen.

Genvejstast

En definition af den genvejstast som aktiverer dette kommandoobjekt.

Stak

Programmets stakst�rrelse. ToolManager gennemtvinger en minimumsst�rrelse p� 4096 bytes.

Prioritet

Kommandoprogrammets prioritet. Normalt skal man holde sig til standardv�rdien 0.

Argumenter

Hvis denne knap er valgt, bliver filer overgivet til kommandoen som startargumenter. Ellers tages der ikke hensyn til filerne.

I forgrund

Hvis denne knap er valgt, vil den angivne offentlige sk�rm blive lagt i forgrunden inden kommandoen startes.

Aktuelt katalog

Kommandoen startes fra dette katalog.

S�gesti

Her kan man angive en liste af kataloger (adskilt med semikolon) som benyttes af shell-kommandoer til at s�ge efter andre programmer.

Uddatafil

Shell-kommandoers uddata omdirigeres til denne fil. Hvis man angiver et konsol-vindue vil shell-kommandoens ud- og inddata blive omdirigeret til dette vindue.

Offentlig sk�rm

Angiver den offentlige sk�rm som skal l�gges i forgrunden f�r kommandoen startes.

7.3 Hvordan man indstiller billedobjekter

Billedobjekter indeholder oplysninger om billeder. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn.

Fil

Navnet p� den fil hvorfra billeddata skal indl�ses. Normalt skal man fjerne endelsen ‘.info’ hvis man vil indl�se en ikon-fil.

7.4 Hvordan man indstiller lydobjekter

Lydobjekter indeholder oplysninger om lyde. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn.

Kommando

Den ARexx-kommando som skal sendes til den eksterne lydafspiller.

ARexx-port

Den eksterne lydafspillers ARexx-portnavn. Standardindstillingen er PLAY, som benyttes af programmet ‘upd’.

7.5 Hvordan man indstiller menuobjekter

Menuobjekter indeholder oplysninger om menupunkter i Workbenchs V�rkt�js-menu. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn. Dette benyttes ogs� til at oprette menupunktet.

Kommandoobjekt

Henvisning til det tilknyttede Kommandoobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere det tilknyttede objekt ved at klikke p� det.

Lydobjekt

Henvisning til det tilknyttede lydobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere det tilknyttede objekt ved at klikke p� det.

7.6 Hvordan man indstiller ikonobjekter

Ikonobjekter indeholder oplysninger om ikoner i Workbench-vinduet. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn.

Kommandoobjekt

Henvisning til det tilknyttede Kommandoobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere det tilknyttede objekt ved at klikke p� det.

Billedobjekt

Henvisning til det tilknyttede billedobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere det tilknyttede objekt ved at klikke p� det.

Lydobjekt

Henvisning til det tilknyttede lydobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere det tilknyttede objekt ved at klikke p� det.

Position

Angiver ikonets X- og Y-koordinater, f.eks. for X = 100 og Y = 55 indtaster man 100/55. Koordinaterne er i forhold til Workbench-vinduets �verste venstre hj�rne.

Vise navn

Hvis denne knap er valgt, vises objektets navn under ikonet.

7.7 Hvordan man indstiller dok-objekter

Dok-objekter indeholder oplysninger om dok-vinduer. Indstillingsvinduet har f�lgende knapper:

Navn

Objektets navn. Dette benyttes ogs� som vinduestitel.

Genvejstast

En definition af den genvejstast som �bner og lukker dok-vinduet.

Offentlig sk�rm

Angiver den offentlige sk�rm p� hvilken dok-vinduet �bnes. Man skal angive et gyldigt navn p� en offentlig sk�rm hvis man vil anvende den automatiske �bning og lukning af dok-vinduer.

Skriftsnit

Dette skriftsnit benyttes til knapteksterne.

Kolonner

Antallet af kolonner i dok-vinduet. Kolonnerne vil blive udfyldt med knapper fra venstre mod h�jre. Hvis den sidste kolonne i en r�kke er fuld, tilf�jes en ny knapr�kke. Alle knapper vil have samme bredde og h�jde.

Position

Angiver dok-vinduets X- og Y-koordinater, f.eks. for X = 150 og Y = 200 indtaster man 150/200. Koordinaterne er i forhold til sk�rmens �verste venstre hj�rne.

Poster

Hver post i denne liste opretter en knap. Den venstre kolonne indeholder henvisningen til det tilknyttede kommandoobjekt, den midterste kolonne henvisningen til det tilknyttede billedobjekt og den h�jre kolonne henvisningen til det tilknyttede lydobjekt. Brug tr�k&slip fra hovedvinduet eller en udklipsholder for at tilknytte et objekt. Man kan redigere de tilknyttede objekter ved at klikke p� dem. Man kan bruge tr�k&slip til at sortere posterne i listen. N�r man trykker p� Slette-knappen, fjernes den aktuelt markerede post fra listen. Selve de tilknyttede objekter slettes ikke.

Aktiveret

Dok-vinduet �bnes n�r indstillingerne er indl�st.

Baggrund

Dok-vinduet flyttes til baggrunden n�r det er �bnet.

Ramme

N�r denne knap er valgt, ser dok-vinduet ud som et almindeligt vindue med ramme og vinduesknapper. Ellers vil det slet ingen ramme have. Bem�rk at dok-vinduet kun kan flyttes hvis det har en ramme.

Menu

En menu tilknyttes dok-vinduet. Menuen giver mulighed for at lukke dok-vinduet, starte ToolManagers indstillingsprogram eller afslutte ToolManager.

Forreste

N�r denne knap er valgt, vil dok-vinduet altid �bne p� den forreste offentlige sk�rm.

Duk-op

Dok-vinduet lukkes automatisk n�r en knap er valgt.

Centreret

Dok-vinduet �bner centreret om den aktuelle museposition.

Station�rt

Normalt husker et dok-vindue sin position n�r man lukker det. Det vil �bne p� denne position n�r man �bner det igen. Hvis denne knap er valgt, vil dok-vinduet altid �bne p� samme position.

Billeder

Knapperne i dok-vinduet vil vise billeder. Bem�rk at man i s� fald skal tilknytte billedobjekter.

Tekst

Knapperne i dok-vinduet vil vise navnet p� det tilknyttede kommandoobjekt. Bem�rk at man i s� fald skal tilknytte kommandoobjekter til dok-posterne.

7.8 Hvordan man omd�ber en objektgruppe

Man kan �ndre gruppens navn med navne-tekstknappen.

7.9 Objekt-udklipsholder

Dette vindue indeholder en liste med tilknyttede kommandoobjekter, billedobjekter og lydobjekter. Man kan tr�kke objekter fra denne liste hen p� indstillingsvinduer. Man kan redigere de tilknyttede objekter ved at dobbeltklikke p� dem. N�r man trykker p� Slette-knappen fjernes det aktuelt markerede objekt fra listen. Selve objektet slettes ikke.

Udklipsholderen kan �bnes fra menuen i hovedvinduet. Man kan have flere udklipsholdere �bne samtidig.

7.10 Globale ToolManager-tilvalg

Dette vindue giver mulighed for at �ndre ToolManagers globale tilvalg. Det kan �bnes fra menuen i hovedvinduet. Det har f�lgende knapper:

Aktuelt katalog

Angiver det aktuelle katalog for ToolManager-processen. Alle filer uden absolut stiangivelse vil blive �bnet i forhold til dette katalog. Standardkataloget er opstartsdisken.

Indstillingsprogram

Stien til den udf�rbare fil for ToolManagers indstillingsprogram. Standardindstillingen er ‘SYS:Prefs/ToolManager’.

Aktivere netv�rk

Ikke underst�ttet i �jeblikket.

Aktivere farvegendannelse

Aktiverer farvegendannelse for picture.datatype. Deaktiver kun dette hvis billederne i dok-vinduerne fremviser forkerte farver.

Gendannelsesn�jagtighed

Angiver farvegendannelsens n�jagtighed. Man kan fors�ge sig med at �ndre denne v�rdi hvis gendannelsesalgoritmens farvevalg er utilfredsstillende p� ens system.

Appendix A Hvordan man definerer en genvejstast

Dette kapitel beskriver hvordan man definerer en genvejstast som en inddatabeskrivelsesstreng, som s� tolkes af Commodities. Hver gang en genvejstast aktiveres genererer Commodities en h�ndelse som benyttes af ToolManager til at aktivere kommandoobjekter eller til at �bne eller lukke dok-objekter. En beskrivelsesstreng har f�lgende syntaks:

[<klasse>] {[-][<kvalifikator>]} [-][upstroke] [<tastkode>]

Alle n�gleord er f�lsomme med hensyn til store/sm� bogstaver.

klasse beskriver inddatah�ndelsens klasse. Dette parameter er valgfrit, og hvis det mangler, benyttes standardv�rdien rawkey. See section Inddatah�ndelses-klasser.

Kvalifikatorer er “signaler”, som enten skal v�re til stede eller frav�rende, n�r genvejstasten aktiveres; ellers vil der ikke blive genereret nogen h�ndelse. For hver kvalifikator som skal v�re til stede skal man medgive dens n�gleord. Alle andre kvalifikatorer forventes at v�re frav�rende som standard. Hvis man vil ignorere en kvalifikator s�tter man blot et - foran dets n�gleord. See section Kvalifikatorer.

En genvejstast-h�ndelse genereres normalt n�r en tast trykkes ned. Hvis h�ndelsen skal genereres n�r tasten slippes, skal man medgive n�gleordet upstroke. N�r b�de nedtrykning og slipning af tasten skal generere en h�ndelse benytter man -upstroke.

Tastkoden afh�nger af inddatah�ndelsens klasse. See section Tastkoder.

Bem�rk: Man skal v�lge sine genvejstaster med omhu, da Commodities har en h�j prioritet i behandlingsk�den for inddatah�ndelser, dvs. den vil erstatte eksisterende definitioner.

A.1 Inddatah�ndelses-klasser

Commodities underst�tter de fleste inddatah�ndelses-klasser som genereres af input.device. Dette afsnit beskriver de klasser som er mest nyttige for ToolManager-genvejstaster.

rawkey

Dette er den normale klasse som d�kker alle tastaturh�ndelser. For eksempel genererer rawkey a eller a en h�ndelse hver gang tasten “a” nedtrykkes. Man skal angive en tastkode for dennne klasse. See section rawkey.

rawmouse

Denne klasse beskriver alle musetast-h�ndelser. Man skal angive en tastkode for dennne klasse. See section rawmouse.

diskinserted

H�ndelser fra denne klasse genereres n�r en disk inds�ttes i et drev. Denne klasse har ingen tastkoder.

diskremoved

H�ndelser fra denne klasse genereres n�r en disk fjernes fra et drev. Denne klasse har ingen tastkoder.

A.2 Kvalifikatorer

Commodities underst�tter f�lgende kvalifikatorer:

lshift, left_shift

Venstre skiftetast.

rshift, right_shift

H�jre skiftetast.

shift

En vilk�rlig af skiftetasterne.

capslock, caps_lock

Caps lock-tasten.

caps

En skiftetast eller caps lock-tasten.

control, ctrl

Ctrl-tasten.

lalt, left_alt

Venstre alt-tast.

ralt, right_alt

H�jre alt-tast.

alt

En vilk�rlig af alt-tasterne.

lcommand, lamiga, left_amiga, left_command

Venstre Amiga-/kommandotast.

rcommand, ramiga, right_amiga, right_command

H�jre Amiga-/kommandotast.

numericpad, numpad, num_pad, numeric_pad

Dette n�gleord skal benyttes for enhver tast p� det numeriske tastatur.

leftbutton, lbutton, left_button

Venstre musetast.

midbutton, mbutton, middlebutton, middle_button

Midterste musetast.

rbutton, rightbutton, right_button

H�jre musetast.

repeat

Denne kvalifikator er til stede n�r tastaturets gentagelsesfunktion er aktiv. Den er kun nyttig for inddatah�ndelses-klassen rawkey.

A.3 Tastkoder

Hver inddatah�ndelses-klasse har sine egne tastkoder:

A.3.1 Tastkoder for inddatah�ndelses-klassen rawkey

a-z, 0-9, …

ASCII-tegn

f1, f2, …, f10, f11, f12

Funktionstaster

up, cursor_up, down, cursor_down

left, cursor_left, right, cursor_right

Piltaster

esc, escape, backspace, del, help

tab, comma, return, space, spacebar

Specialtaster

enter, insert, delete

page_up, page_down, home, end

Taster p� det numeriske tastatur. Hver kode skal benyttes med numericpad som n�gleord til at angive kvalifikatoren!

A.3.2 Tastkoder for inddatah�ndelses-klassen rawmouse

mouse_leftpress

Tryk p� venstre musetast

mouse_middlepress

Tryk p� midterste musetast

mouse_rightpress

Tryk p� h�jre musetast

Bem�rk: For at benytte �n af disse tastkoder skal man ogs� angive det tilsvarende kvalifikator-n�gleord, f.eks.

rawmouse leftbutton mouse_leftpress

A.4 Eksempler p� genvejstaster

ralt t

Venstre alt-tast holdes nede og “t” nedtrykkes

ralt lalt t

Venstre og h�jre alt-taster holdes nede og “t” nedtrykkes

alt t

En vilk�rlig alt-tast holdes nede og “t” nedtrykkes

rcommand f2

H�jre Amiga-tast holdes nede og den anden funktionstast nedtrykkes

numericpad enter

Enter-tasten p� det numeriske tastatur nedtrykkes

rawmouse midbutton leftbutton mouse_leftpress

Den midterste musetast holdes nede og den venstre musetast nedtrykkes

diskinserted

En disk inds�ttes i et vilk�rligt drev

Appendix B Ofte stillede sp�rgsm�l

Her er svarene p� de oftest stillede sp�rgsm�l om ToolManager:

• - N�r jeg starter ToolManagers indstillingsprogram kommer der kun en dialogboks med teksten “Program initialization failed!”. Hvad er der galt?

  Indstillingsprogrammet kontrollerer sine grundl�ggende krav f�r det �bner det f�rste vindue. Kontroll�r at disse krav er opfyldt! Dit system kan ogs� v�re ved at l�be t�r for hukommelse. Du er m�ske n�dt til at afslutte nogle andre programmer f�rst for at f� nok hukommelse ledig til at afvikle ToolManagers indstillingsprogram. Der kan ogs� kun afvikles �t indstillingsprogram ad gangen.

• - Hvordan kan jeg afvikle ToolManagers indstillingsprogram p� en anden offentlig sk�rm end Workbench-sk�rmen?

  V�lg punktet MUI... fra indstillingsmenuen i hovedvinduets menu. V�lg nu indstillingssiden System og indtast navnet p� den offentlige sk�rm i tekstknappen. For yderligere detaljer henvises til dokumentationen for Oplysninger om MUI.

• - Efter konvertering af mine gamle indstillinger fra ToolManager 2.x mangler der nogle billeder i dok-vinduerne, og nogle dok-vinduer kommer slet ikke frem!

  ToolManager 3.0 underst�tter i dok-vinduer kun billedfiler som kan tilg�s via picture.datatype. I dine gamle indstillinger har du til dok-objekterne knyttet nogle billedobjekter som henviser til ikonfiler. For at benytte ikonfiler skal du installere en ikon-datatype p� dit system. En s�dan datatype kan f.eks. findes p� Aminet. Du kan ogs� konvertere dem til f.eks. IFF-pensler.

• - Efter konvertering af mine gamle indstillinger fra ToolManager 2.x mangler der nogle af ikonerne i Workbench-vinduet!

  ToolManager 3.0 underst�tter kun ikonfiler for ikonobjekter. I dine gamle indstillinger har du til ikonobjekterne knyttet nogle billedobjekter som henviser til IFF-pensler. Du skal konvertere dem til ikonfiler for at benytte dem sammen med ikonobjekter i ToolManager 3.0.

• - N�r jeg benytter ikonfiler til billeder i dok-vinduerne er der nogle ekstra tekster knyttet til billedet, eller det har en bred ramme. Hvad er der galt?

  Du har p� dit system installeret en ikon-datatype som inds�tter ekstra oplysninger fra ikonet i billedet. Se i dokumentationen for ikon-datatypen hvordan disse oplysninger kan undertrykkes. Hvis du ikke bryder dig om den brede ramme, skal du ogs� bede ikon-datatypen om ikke at generere de s�dvanlige ikon-rammer.

• - Hvorfor kan ToolManager ikke oprette flere V�rkt�js-menuer eller undermenuer?

  Flere menuer eller undermenuer underst�ttes i �jeblikket ikke af Workbench. For at oprette dem skal man hacke dem ind i AmigaOS, hvilket kan medf�re et ustabilt system. Derfor vil jeg ikke implementere det i ToolManager.

• - Hvordan kan jeg oprette et vandret dok-vindue?

  Angiv blot samme antal kolonner som antallet af poster i dok-objektet.

• - Hvordan kan jeg oprette et uddatavindue for shell-programmer?

  Uddatavinduer kan oprettes ved brug af CON:-drivprogrammet. Benyt f�lgende som filnavn for at oprette et automatisk �bnet vindue med lukkeknap, som ikke lukker efter at programmet er afsluttet:

  CON:10/10/640/100/Uddatavindue/AUTO/CLOSE/WAIT
  

  CON:-drivprogrammet har mange valgmuligheder, se i din AmigaDOS-manual for yderligere oplysninger.

• - Hvordan kan jeg inds�tte argumenterne midt i en Shell-/ARexx-kommandolinie?

  Normalt tilf�jes alle argumenter til kommandolinien. For at inds�tte argumenterne hvorsomhelst i kommandolinien anvender ToolManager samme []-syntaks som benyttes af kommandoen alias i AmigaShell. S� for eksempel vil

  Dir [] all
  

  inds�tte alle argumenter f�r n�gleordet all.

• - Hvordan kan jeg oprette under-dokker?

  Du skal benytte kommandoobjekter af typen Dok. Inds�t s�danne objekter i posterne i din hoved-dok, og de vil �bne/lukke de andre dokker.

• - Dok-vinduerne forsvinder n�r Workbench-sk�rmen lukkes og gen�bnes.

  Du har glemt at s�tte navnet p� den offentlige sk�rm for dok-vinduet til Workbench. ToolManager lukker dok-vinduer n�r den offentlige sk�rm lukkes. Men den er n�dt til at vide p� hvilken offentlig sk�rm dok-vinduerne skal v�re for at kunne �bne dem automatisk n�r den offentlige sk�rm �bnes igen.

Appendix C ToolManagers programhistorik

3.0, Release date 23.02.1997

• - Again rewritten (almost) from scratch :-)
• - Old object system removed, TM objects are now BOOPSI objects
• - Now uses memory pools
• - Delay parameter removed from Exec Objects
• - Animation support removed from Image Objects
• - Picture.datatype V43 support added to Image Objects
• - Only icon images supported for Icon Objects
• - Only images loadable via picture.datatype are supported in Dock Objects
• - Pattern & Vertical flags and Title parameter removed from Dock Objects
• - Dock Objects can now display text and images
• - Dock Objects can now be completely borderless
• - New preferences file format, hopefully more flexible
• - Converter for the ToolManager 2.x format
• - Events are now checked while the configuration is read
• - Preferences is now a MUI application: resizable window, multiple open edit windows and Drag&Drop support
• - Changing an object name automatically updates all references to the object.
• - Support for grouping objects.
• - All dock objects get the screen notifications
• - Added support for DOSPath 1.0
• - CLI command lines are not limited to 4KB anymore
• - Installer script

2.1b, Release date 13.03.1996

• - Minor update to 2.1
• - Added support for WBStart 2.0

2.1a, Release date 26.03.1995

• - Minor update to 2.1
• - Added support for ScreenNotify 1.0
• - Included newer version of WBStart-Handler
• - Included missing AutoDocs for toolmanager.library

2.1, Release date 16.05.1993, Fish Disks #872 & #873

• - New Exec object types: Dock, Hot Key, Network
• - New Dock object flags: Backdrop, Sticky
• - New object type: Access
• - Network support
• - Editor main window is now an AppWindow
• - Gadget keyboard shortcuts in the preferences editor
• - New tooltypes for the preferences editor
• - Several bug fixes
• - Enhanced documentation

2.0, Release date 26.09.1992, Fish Disk #752

• - Complete new concept (object oriented)
• - (Almost) Complete rewrite
• - ToolManager is now split up into two parts
• - Main handler is now embedded into a shared library
• - Configuration is now handled by a Preferences program
• - Configuration file format has changed again :-) It is an IFF File now and resides in ENV:
• - Multiple Docks and multi-column Docks
• - Docks with new window design
• - Dock automatically detects largest image size
• - Sound support
• - Direct ARexx support for Exec objects
• - ToolManager can be used without the Workbench. If the Workbench isn’t running, it won’t use any App* features.
• - Locale support
• - Path from Workbench will be used for CLI tools
• - Seperate Handler Task for starting WB processes

1.5, Release date 10.10.1991, Fish Disk #551

• - Status Window: New/Open/Append/Save As menu items for config file
• - Edit Window: File requesters for file string gadgets
• - Added a Dock Window (a la NeXT)
• - Added a DeleteTool
• - A list of all active HotKeys can be shown
• - Tools can be moved around in the list
• - Icon positioning in the edit window added
• - Name of the program icon can be set
• - CLI tools can have an output file and a path list
• - Uses UserShell for CLI tools
• - Maximum command line length for CLI tools is now 4096 Bytes
• - AppIcons without a name are supported now
• - Workbench screen will be moved to front if you pop up the Status window
• - Workbench screen can be moved to front before starting a tool via HotKey
• - TM will wait up to 20 seconds for the workbench.library
• - Added a DELAY switch which causes TM to wait <num> seconds before adding any App* stuff
• - renamed some tooltypes/parameters
• - some visual cues added
• - some internal changes

1.4, Release date 09.07.1991, Fish Disk #527

• - Keyboard short cuts for tools
• - AppIcons for tools
• - Menu item can be switched off
• - Configuration file format completely changed (hopefully the last time)
• - CLI commandline parsing is now done by ReadArgs()
• - Status & edit window updated to new features
• - Safety check before program shutdown added
• - Menu item “Open TM Window” only appears if the program icon is disabled
• - WB startup method changed. Now supports project icons
• - several internal changes

1.3, Release date 13.03.1991, Fish Disk #476

• - Now supports different configuration files
• - Format of the configuration file slightly changed
• - Tool definitions can be changed at runtime
• - Now supports CLI & Workbench startup method
• - Selected icons are passed as parameters to the tools
• - Now uses the startup icon as program icon if started from Workbench
• - The position of the icon can now be supplied in the configuration file
• - The program icon can now be disabled
• - New menu entry “Show TM Window”
• - Every new started ToolManager passes its startup parameters to the already running ToolManager process

1.2, Release date 12.01.1991, Fish Disk #442

• - Status window changed to a no-GZZ & simple refresh type (this should save some bytes)
• - Status window remembers its last position
• - New status window gadget “Save Configuration”: saves the actual tool list in the configuration file
• - Small bugs removed in the ListView gadget handling
• - Name of the icon hard-wired to “ToolManager”

1.1, Release date 01.01.1991

• - Icons can be dropped on the status window
• - Status window contains a list of all tool names
• - Tools can be removed from the list

1.0, Release date 04.11.1990

• - Initial release

Appendix D Autor vil gerne takke…

ToolManager har gennemg�et mange store udviklingsm�ssige faser siden sin f�rste implementering medio 1990. Denne udvikling ville have v�ret umulig hvis jeg ikke havde f�et den enorme m�ngde tilbagemeldinger fra forskellige brugere af ToolManager. Mange ideer og faciliteter stammer fra denne kilde…

Derfor vil jeg gerne takke:

For alfa-/beta-afpr�vning, ideer og fejlrapporter:

Osma Ahvenlampi, Stephane Barbaray, Olaf Barthel, Fionn Behrens, Mario Cattaneo, Michael van Elst, Michael Hohmann, Markus Illenseer, Frank Mariak, Klaus Melchior, Bernhard Moellemann, Matthias Scheler, Ralph Schmidt, Tobias Walter.

Matthew Dillon

Uden dit fremragende C-udviklingssystem DICE og forskellige andre v�rkt�jer ville ToolManager ikke eksistere!

Alle brugere som har sendt mig penge:

Jeres st�tte har muliggjort denne udgave.

Alle brugere som har sendt mig en meddelelse:

Jeg har virkelig nydt at l�se jeres breve og e-post!

ToolManager anvender f�lgende pakker:

picture.datatype V43

Copyright © 1995–1996 Ralph Schmidt, Frank Mariak &
Matthias Scheler

WBStart 2.2

Copyright © 1991–1996 Stefan Becker

ScreenNotify 1.0

Copyright © 1995 Stefan Becker

DOSPath 1.0

Copyright © 1996 Stefan Becker

MUI

Copyright © 1993–1997 Stefan Stuntz
World Wide Web-hjemmeside: http://www.sasg.com/.

Pophotkey.mcc, Popport.mcc, Popposition.mcc

Copyright © 1996–1997 Klaus Melchior

Ikoner

Copyright © 1995 Michael W. Hohmann

Appendix E Oplysninger om MUI

                        Denne applikation bruger


                        MUI - MagicUserInterface

                (c) Copyright 1993-97 af Stefan Stuntz


MUI er et system til at generere og vedligeholde grafiske brugerflader.
Ved hj�lp af et indstillingsprogram kan brugeren af en applikation selv
indstille udseendet efter sin personlige smag.

MUI distribueres som shareware. For at f� fat i en komplet pakke med en
m�ngde eksempler og flere oplysninger om registrering bedes du se efter
en fil ved navn "muiXXusr.lha" (XX st�r for seneste versions-nummer) p�
dine lokale BBS'er eller p� public domain-diske.

               Hvis du vil registrere direkte, s� send blot


                        DM 30.-  eller  US$ 20.-

                                  til

                             Stefan Stuntz
                        Eduard-Spranger-Stra�e 7
                             80935 M�nchen
                               TYSKLAND



               Support og online-registrering kan findes p�

                          http://www.sasg.com/

Indeks

Table of Contents

About This Document

This document was generated on August 24, 2022 using texi2html 5.0.

The buttons in the navigation panels have the following meaning:

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

• 1. Section One
  • 1.1 Subsection One-One
    • ...
  • 1.2 Subsection One-Two
    • 1.2.1 Subsubsection One-Two-One
    • 1.2.2 Subsubsection One-Two-Two
    • 1.2.3 Subsubsection One-Two-Three     <== Current Position
    • 1.2.4 Subsubsection One-Two-Four
  • 1.3 Subsection One-Three
    • ...
  • 1.4 Subsection One-Four

This document was generated on August 24, 2022 using texi2html 5.0.